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SECTION 1 : GENERAL 
IHTRODUCTKW 

The Nanodata Control System (NCS) is an elementary control system that 
operates on the NOVA emulator developed for the QM- 1 . 

The NOVA emulator supports a card reader, line printer, card punch, 
cartridge unit, sixteen magnetic tape units, a teletype, a paper tape 
punch, and a disk with a fixed pack and removable pack. 

NCS provides the user with a basic set of utilities using the QM-1 
associated peripherals. 

Information files on various media (cards, magnetic tape, disk, etc.) 
generally represent either binary files or sourcecode files. Internal to 
the computer, sourcecode uses a 7-bit ASCII representation with zero 
parity (leftmost) bit in an 8-bit byte. Some utilities will recognize 
"packed sourcecode" where a byte with MSB=1 represents a (negative) count 
of extra repetitions for the last true character. (Eighty asterisks would 
pack into ••»" followed by -79.) 

This document consists of a set of procedures for using the utilities 
provided by NCS. Familiarity with the operation of the C^-1 system 
hardware is assumed. Procedures for bootstrap loading and operation of the 
hardware switches are contained in the "C^-1 Console Reference Manual". 
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NOTATION 

The following notation is used in this document to formalize the format of 
the procedures. 

1 . Literals are shown in upper case and are entered or displayed as 
written. 

2. Variables are shown in lower case. The appropriate name or value is 
substituted before entry or display. 

3. Letters supplied by NCS utilities are underscored (e.g. VOLUME means 
that V was keyed in and OLUME was supplied by the executing utility). 

4. Brackets [ ] enclose optional parameters. 

5. Braces Tf enclose a set of parameters from which one must be 
selected. 

6. Ellipses . . . indicate repetition. 

7. (n) indicates the CONTROL character "n" and is the equivalent of CTRL n 

as used in the Tektronix 4023 Computer Display Terminal users Manual. 
It is entered by pressing a letter key while CTRL is held down. 

8. A is any C^-l delimiter (hyphen, comma, blank, carriage return, 
period) . 



1-2 



NCS CONTROL CffliMAIiDS 

The NOVA* emulator responds to the ^s^ entry. ^s^ followed by certain 
letters forms commands to the emulator. These commands correspond to the 
switches on the front panel of the NOVA computer. 

Table 1 contains the set of commands recognized by the NOVA emulator and 
their functions. (H) after the function description indicates that the 
emulator must be halted when the code is entered. 



Command 
ESC 

© H 

^) Snnnnnng 

© L 

© R 



(V) G 

(3^ Pnnnnnng 



s) Bn 



8 



CR 
space 



Function 

Escape from ^s) entry 

Halt the running NOVA emulator 

Set the NOVA switches 

Load NCS by executing the bootstrap from 
disk (H) 

Restart at NOVA location indicated by the 
switch setting (H) 

Go. Continue from HALT (H) 

Enter NOVA program counter (H) 

Enter new CRT Baud rate where "=9600 (h) 

BAUD 

Select print train (H) 

S = standard subset (64 char), A = ASCII (128 char) 



Entervalue just keyed for (s^ S, (£) P, (s) B, 
or (s) X commands. Delimiters are not expected 
after other commands. 



Table 1. NCS Control Commands. 

*NOVA is a registered trademark of Data General Corporation 
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Any codes not in Table 1 are displayed on the CRT and are Ignored by the 
emulator. Also, any command entered at the wrong time is ignored and 
displayed on the CRT. (e.g., (s) H when the NOVA is already halted.) 

SETTING F-SWITCH (on the C^-1 front panel) to one will cause the emulator 
to treat the HALT instruction as a no op. 

Setting emulated switch 17 [ S^IXXXXX] "unlocks" control store allowing 
MLD, QMLD, and USER to function properly. 
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NCS DISK SYSTEM 

The NOVA emulator supports a disk system containing a single fixed platter 
with a single removable disk platter. The N9755 disk has been partitioned 
into 10 equal sized partitions, numbered through 9. Since the NOVA 
emulator only supports two disk platters, only two of the partitions 
(called USER'S) are recognized at any given time. The first partition, 
USER 0, has been permanently assigned the function of the fixed pack. Any 
one of the other USER'S (1 through 9) can be dynamically assigned the 
function of the removable pack. USER assignment is accomplished through 
the use of the USER utility, described in Section 2. 

When the NOVA emulator is loaded, the removable pack assignment is 
defaulted to USER 1 and must be reassigned if any other USER is desired. 

Throughout the rest of this document, the fixed pack is referred to as the 
SYSTEM pack, and the removable pack is referred to as the USER pack. 

Each USER is divided into cylinders and sectors. There are 400^^ cylinders 
each containing 2^4 ^q sectors, giving a total of 9600 ^q (22600g) sectors. 
Each sector contains 256.. 1 8-bit words. The NOVA normally manipulates 
this data as 256. q 1 6-bit words. Thus, utilities such as SAVE and RESTORE 
will lose the top two bits of each l8-bit word, if attempting to handle 
18-bit-word files (such as MULTI microcode). 
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There is no communication between USER'S 1 through 9. To move a file from 
one USER to another, it must be copied from the currently assigned USER to 
tape or to a USER disk file and then copied to a reassigned USER. 

Each USER contains a file directory which contains the entries defining up 
to 192 files. Each definition consists of a file name plus the file block 
parameters describing the file. Each file name must be unique to that 
USER. 

File declarations are made with the FILES utility and specify the starting 
address on the disk in terms of cylinders and sectors, the number of 
sectors to be allocated, the type of file, the date of creation, and the 
program file pareimeters for core image program files. 

File declarations allow overlapping files. This is useful for such things 
as partitioning a large work file or for defining a file that is 22600g 
sectors long, beginning at cylinder and sector to declare the entire 
USER as one file. 
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SECTION 2: UTILITIES 

NCS provides a set of utilities for use in creating, transferring, 
manipulating, and executing programs and to perform memory and disk 
housekeeping functions . 

This section contains a description of the function and a procedure for 
using each utility. The following table lists the utilities and gives a 
brief description of their functions. 



Utility 



Function 



Assemblers 

BOOT 

BUILD 

COMPARE 

COPY 

COPYD 

DISCART 

EX 

EXEC 

FILES 

FREE 

LD 

MAP 

NOVA MEMORY DUMP 

PREP 

QMLD 

RESTORE 

REWIND 



Assembles nanocode, microcode, and NOVA code. 

Displays/modifies a mapped nanostore binary file. 

Copies an NCS file from cartridge tape to disk file. 

Compares two files, line by line. 

Copies an NCS file from one device to another. 

Fast copy between disk files alone. 

Copies an NCS file from disk to cartridge tape. 

Uses input parameters from a file instead of keyins. 

Uses input parameters from a file called COMMANDS. 

Adds, deletes, changes and reports status of NCS files. 

Displays the graphic FREE on the CRT. 

Loads a NOVA binary program into memory from a disk file. 

Maps the binary output of the nanoassembler. 

Dumps a specified range of NOVA memory to the line printer. 

Places a loadable file on cartridge tape from disk files. 

Loads mainstore, control store and nanostore from disk files. 

Copies an NCS file from magnetic tape to disk file. 

Rewinds the magnetic tape or cartridge tape. 
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.s 

SAVE 

SYSINIT 

XC 

UPDATE 

USER 

ZAP 

* and $ 



Sets the NOVA program counter for program execution. 

Copies an NCS file from disk to magnetic tape. 

Initializes an NCS USER. 

Cross copy of l6-bit/wd files between any users, any 

disks. 

Line-editor for sourcecode files. 

Assigns a specified USER as the NOVA removable pack. 

Clears NOVA user memory. 

Manipulates NOVA progreims. 



Table 2: NCS Utilities 
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ASSEMBLING PROGRAMS 

Both the nanoassembler and the microassembler can be invoked under NCS. A 

detailed discussion of the use of the nanoassembler is included in the 

HARDWARE LEVEL USERS MANUAL. The microassembler is described in the QM 

MICROASSEMBLER REFERENCE MANUAL. This procedure presupposes a knowledge 

of the assemblers. 

Assembling Nanoprograms 

The nanoassembler is invoked to assemble only nanoprograms. 

/binary- file A 
Format: 2NP[NL] A INPT_=source-file A BIN= f a 

NL listing suppression options 

source-file file containing a source nanoprogram 

binary-file file containing the binary output of the nanoassembly. 
If binary- file is omitted, the binary is not saved. 

To generate a definition file only, the following format is used: 

Format: _!,LD,»NASPC A 

l.S=1 

J_.S=2 A INPT = source-f ile A BIN = definition-binary file A (with listing) 

or 
!.S=M A INPT = source-file A BIN = definition-binary file A (no listing) 



Setting switch 15 ( (S) SI 00000) will cause suppression of all printer 
output. 

Setting switch 14 ((^S40000) will cause the listing to be printed on the 
console instead of the line printer. No symbol table listing is generated. 
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Assembling Microprograms 

The microassembler is invoked to assemble either NOVA assembly language 
programs or microprograms. Microprograms require a definition file. If no 
definition file is specified, the microassembler assumes the source is 

NOVA assembly language program. . x 

(definition-file^ 
Format: J[MA[ -options] A DBF = f ^ _) INPT = source file[ . . .source-fili 

/ binary- file^ 
BIN_£> A 3 

-options [L][X][N][A] listing options as described in the QM 
MICROASSEMBLER MANUAL. 

definition-file file containing the instruction set definitions and 
symbolic neimes - output from a nanoassembly. This 
file is required for microprograms. If none is 
specified, a NOVA source program is assumed. 

source-file file containing the source program to be input to the 
microassembler . 

binary-file file containing the binary output of the 
microassembler . 

When not preceded by a binary- file name, A indicates 
that the binary is not to be saved. 

All output is directed to the line printer unless otherwise specified. 

When using the microassembler, the A option will direct output to the 

console. However, this option suppresses the symbol table listing. 

Setting switch 15 ((|)STOOOOO) will cause all listing, including errors, to 

be suppressed. 
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BOOT 



BOOT can be used to modify words or bytes in a nanoprogram residing in a 
disk file. 

Format: j_BOOTA 

FILENAME = filename A 
^command 

filename specifies the file to be modified. Command is one of the four 
BOOT commands. The BOOT commands and their functions are listed in 
Table 3. 

Error Messages: 

If the nanoword is not specified as octal digits, ? is displayed and a new 

address is expected. If the nanobyte exceeds 19, the ADDRESS = prompt is 

redisplayed. 

If filename is not valid, the FILENAME = prompt is redisplayed. Commands X, 
Y, T, R, P, Q, F, G, H, and I provide special functions not available on the 
QM-1 and may cause BOOT to simply hang. Entering (s) R or @ L is the only 
recovery. 
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Command 



Function 



•C 
ADDRESS 



= nanoword-address A 



•M 

ADDRESS 



nanowordg, nanobyte.Q 

B nanobyte 

+ displacement 

- displacement 



Example: 

»M 

ADDRESS = 
E B N M D 
N R A 1 M 
T N N C S 



1,0 
H F 
L S 



KN 



P H U 



000000000000000000 

or 

ADDRESS = 1,13 
XRLGTURG 
IIEEXN3SI AUX-1 U F-SEL-1 
00SSXC1HN T 
000000000000000000 



Clears the specified nanoword to zero. 
This process clears all 18 bits of all 
20 nanobytes of the nanoword. Upon 
completion, the prompt character * is 
redisplayed. 

Modifies the specified nanobyte. The 
nanoword and nanobyte entries are 
separated by a comma. The nanoword 
is specified in octal, but the nanobyte 
is a decimal integer from through 19. 

As each address is entered, the specified 
nanobyte is retrieved from the disk file 
and displayed on the screen in a binary 
format. Each bit or set of bits is 
identified in the display. 

A blank (B) in place of "nanoword" uses 
the last entered nanoword address as the 
current address. 

Entering a + displacement causes retrieva." 
of the nanobyte displaced by the specifiei 
number of bytes from the last entered 
nanobyte. 

To modify the nanobyte, space to the 
bit to be modified and enter a or 1 . 
Spacing leaves a bit as is. Entering 
a carriage return specifies that no 
more bits are to be modified. The 
modified nanobyte is then written back 
to the file. The modified nanobyte 
will automatically be written back after 
18 bits have been modified or spaced 
over. The ADDRESS = prompt is redisplayet 
and a new nanobyte may be specified. 



•N 
FILENAME 



= filename A 



•K 
•E 
•ESC 



specifies a new file to be modified. 

causes entry to PREP. 

End of Job. Control returns to NCS. 

cancels the current command and redisplay; 
the prompt character. 



Table 3: BOOT Commands 
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BUILD 



BUILD copies a file that has been stored on cartridge tape with the DISCART 
utility to a file on the disk. 



Format: _!^BUILD A 

CART TAPE UNIT NUMBER = unit number A 

TRACK NUMBER = track-number A , 

._ , ^ „-., „.„......„.„.^: 

LOAD FILE = filename 

DATE OF HDR = date 

VOL NUMBER = volume 

START CYLINDER = cylinder 

START SECTOR = sector 

FILE LENGTH = length 

HIT (RETURN) TO VfRITE DISK CR 

unit-number cartridge tape unit number 

first unit = 
second unit = 1 



track-number 
SI 00400 

»* CAUTION ** 



track number 0,1,2, or 3 

switch setting to disable header comparison 
between the saved file and the file definition 
in the destination directory. The file is 
written at the address specified in the header. 

misuse of this option can cause file overwriting. 
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file-marks- to-be- number of file marks to be skipped for posi- 

skippedo tioning. There are two file marks after each 

file. To read multiple files, the starting 
file numbers would be , 2 , M .... 

* skip past specified number of file marks - 

do not rewind before or after the read. 

After the file is read, the next starting 

file is requested. 
+ rewind, skip past specified number of file 

marks - do not rewind after the read. 

After the file is read, the next starting 

file is requested. 
A rewind and skip past the specified number 

of file marks. Rewind after the file is 

read and return to NCS. 
- return directly to NCS. 

filename, date file attributes obtained from header record 

volume, cylinder, of the DISCART's file, 

sector, length 

BUILD will write to an uninitialized USER if the SI 00400 option is 

used. Otherwise, the USER must be initialized with the SYSINIT utility or 

a disk error message will be displayed. 



If the (s) SI 00400 option is not used, the header parameters are examined 
and the destination directory is searched for the filename. If the 
filename has not been defined, or if the length is too short, or if the 
file is write protected, BUILD will ask for an alternate filename. The 
alternate filename must have been defined with appropriate parameters. 
The parameter list for the alternate file is displayed followed by 
HIT (RETURN) TO WRITE DISK 

Error message; 
DISK ERROR 
Disk is not ready. 
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COMPARE 

COMPARE is a utility which reads two souroecode files to determine whether 

they are identical, or at what point they differ. If the two files contain 

identical souroecode, COMPARE quits after reporting 

MATCHED THRU E.O.F. 

The files are compared on a line-by-line basis. If they differ at some 

pairs of lines, COMPARE first displays the contents of the two line 

buffers, each followed by its (implicit) line number, then pauses for user 

response after displaying the user-prompt, 

MORE? (Y. N. 1.2. ESC) 

This user-prompt alone (with the following program pause) also can be 

elicited during a run, if the user creates an interrupt by pressing any key 

on the keyboard. Further operation of COMPARE then depends on the user's 

choice of response. 

RESPONSES MEANING 

Y Yes, begin comparisons on the next pair of lines, 
regardless of whether the current pair had matched or not. 

N No, terminate comparisons on this pair of files. If not in 
A-mode, perform as for ESC (below). If in A-mode, go on to 
the next pair of files (if any). 

1 File#1 advances by one line; both line buffers redisplay. 

2 Filey;^2 advances by one line; both line buffers redisplay. 
ESC Escape unconditionally from COMPARE, back to NCS. 
(other) (repeats the same user-prompt, and again pauses) 
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INVOCATION 

Invocation of the COMPARE utility requires user entry of six parameters and 

allows user entry of certain options. These are two modes of operation, 

depending on whether option "A" is chosen. 

Non-A Mode Invocation 

The comparisons will be on a single pair of files, whose names generally 

will be different. The required parameters come as two sets of three each. 

Format: ^COMPARE [-options not including A] ^ 
1ST FILE: 



DISK-UNIT # (0. 1): 



u, A 

1 



VOL.# (OCTAL. 0-max); v^ A 



FILENAME 



2ND FILE: 



name A 



DISK-UNIT # (0.1): 



u,A 



VOL.#(OCTAL. 0-max); Vg A 
FILENAME = nameg A 



Parameters: 



"r "2 - 



single digit, currently limited to 
or 1. 



^1' 



^2 - 



a one-digit or two-digit octal 
number; max is determined individually 
for the separate disk drives, and will 
be 11 for full NCS disks, or 04 for 
"split packs". 



name^ , name„ 



a one- to ten-character name, existing 
in the directory of the specified Unit 
and Volume; no slash (/) precedes these 
names. 



Options: 



Logging: the line printer will log all items which 
appear on the console CRT, after the "L". 
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U - Unpack: the disk-read subroutine will attempt to 

recognize and unpack, from either or both files, any 
packed sourcecode which may be present, before 
copying the sourcecode into the line buffer. 

Q - Quantify: if the files succeed in being read all the 
way to their ends, then tallies will be displayed for 
the "used" space (non-null bytes tally), and for the 
"unused" space (null-bytes tally), separately for 
each file. These reports will be in terms of full 
sectors, plus number of bytes in the last (partial) 
sector, used/ unused. 

A-Mode Invocation 

Under option "A", the comparisons may continue through many pairs of files, 
each pair having the same name, with names automatically obtained from some 
directory. The purpose is to validate whether all files of a whole USER 
volume match all files of another such volume by name and by content. In 
this mode, new options become available, while those of non-A mode are 
retained. The required parameters, in this case, comprise three sets of 

two each. 

Format: _!^COMPARE-[ options] A [other options] A 
DIRECTORY; 

DISK-UNIT # (0.1): u^A 
VOL.# (OCTAL. 0-max): v^A 
1ST FILE; 
DISK-UNIT # (0.1): u^A 
VOL.# (OCTAL. 0-max); v^A 
2ND FILE; 

DISK-UNIT # (0.1): UgA 
VOL. # (OCTAL. 0-max); VgA 
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Parameters: 



u- 



"2 - 



single digit, currently limited to 
or 1 . 

a one-digit or two-digit octal number; 
max is determined individually for the 
separate disk drives, and will be 11 for 
full NCS disks, or 04 for "split packs". 



Options: A - Automatic filenames: each name will be taken from the 

directory found on unit/volume indicated here as u,, v^. 
A file of this name then will be looked for in the 
directories of both the other units/volumes. 

L - Logging ^ 

U - Unpack < as above (see non-A mode) 

Q - Quantify ) 

N - N-response automatically generated in case of mis- 
matches so that the run can proceed without stopping. 
The prompt "MORE (Y, N, 1, 2, ESC)" will not be dis- 
played, under option "AN", for mismatches. COMPARE 
will go on to the next filename in the master directory, 
or quit if the end of the directory is reached. (With- 
out option "N" a mismatch would cause this prompt to 
be displayed, followed by a pause for user response; 
the user's answer of ESC would then terminate the whole 
run, while an "N" response would force it to go on to 
the next filename.) 

: - Restart at specified name. This colon must be followed 
immediately by a filename, also existing in the speci- 
fied master directory. The purpose is to restart an 
interrupted run without having to recompare all 
preceding files. When execution begins, under options 
"A:", all names from the specified directory are 
passed over if they do not match the given name. This 
name, being a separate input parameter, requires its 
own terminator (A ) . Thus the input sequence could be 
of forms 



J_COMPARE-A[ options not :] :name 

• • • 6 vC • • • 



^[ other options]^ 



J_COMPARE-A[all options not :] :name^ 

« • • GDC • • • 

The resulting full display, for instance under the 
first of these input sequences, would have the form 
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_!^COMPARE-A[ options not :] : 
FILENAME = name A [other options] A 
DIRECTORY: 

■ • • € wO • • • 

REMARKS 

1 . This utility program violates the constraint honored by most NCS 
utilities, that the only accessible files are on the SYSTEM pack and on 
the single USER pack previously selected, on a single disk-drive Unit. 
The program accomplishes this switching among various Units and 
various Volumes via internal calls to the NCS utilities UN and USER. 

2. Neither NCS nor COMPARE has any way of recording what Unit/Volume were 
current at the time that COMPARE was invoked, so a return to that 
assignment cannot be guaranteed. Thus, when control finally returns 
to NCS, the current Unit/Volume assignment will remain at that which 
was last accessed — which may not be where the user wishes to be. 

3. Each line buffer currently is sized at 82 characters, to allow the 
normal (edited) sourceoode format: LF, 80 printables, CR. Used with 
normal sourcecode files, COMPARE computes line numbers which should 
agree with those printed under execution of the MA and UPDATE 
utilities. However, if used with binary files, or with long-line 
printable files (e.g., assembly listings), COMPARE will display line 
numbers which have little meaning, except as a reminder of whether the 
user had advanced one file relative to the other. 
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4. Files to be compared are read as 16-blt-per-word records. Thus 
l8-bit-per-word files (such as MULTI microcode) cannot be guaranteed 
to compare correctly. Binary files, even if containing 
l6-bit-per-word data (such as the emulated-NOVA invokable files), may 
well contain embedded null-bytes which are meaningful. Since COMPARE 
drops null-bytes, comparisons of even these files also should not be 
considered wholly reliable. 

5. The Q (quantify) option, intended to show how much space is needed and 
how much is still available in an existing file, also would not give 
unambiguous results for binary files. This is because the embedded 
null-bytes (if any), before being dropped, are tallied in the same 
counter as are the final padding null-bytes. 

6. Under option A (automatic filenames generation), a name from the 
specified master directory may be found missing from either or both 
Unit/Volume directories where the two comparand files are required to 
be located. The remark 

NO FILE BY THAT NAME ON THIS VOL. 
is then displayed for each such file, and COMPARE skips to the next 
filename in the master directory. 

7. The ESC character can be used to terminate input of parameters, and 
return to NCS. This is true during the option-string input, and also 
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during input of either the u paramater or the v parameter. However 
it is not true during input of each filename. 

8. Under options AN (automatic No), a pair of files whose first lines 
mismatch will not cause the comparisons to terminate. It will take 
mismatch of a later pair of lines to force the termination of 
comparisons on the pair of files. This feature was installed because 
many sourcecode files differ in some minor way (e.g., revision number) 
in the title-lines, whereas what we really wish to display is the first 
line of operable code by which they differ. Thus a first-lines 
mismatch still displays the mismatch (line buffers, followed by line 
numbers both equalling one), but then takes an "automatic Yes". 
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COPY 

This utility copies byte-oriented data from one file or device to another 
file or device. All files (if any) must exist on a single disk drive. 

Format: J^COPY[-options]'^I=sourcecode-inputA O=sourcecode- output^ 

Parameters: sourcecode-input = name of the input file, or device. 

sourcecode-outputs name of the output file, or device. 

Options: U - Unpack the input file contents (meaningful only if 

reading from disk). 

P - Pack the output file contents (meaningful only if 
writing to disk). 

F - Formfeeds are to be made visible (usually for verifi- 
cation purposes only) . Here COPY will use the four 
characters 

< FF > 

to display on the CRT (if 0=»CRT), or to print on 
the lineprinter (if 0=*LPT), at each occurrence of a 
formfeed character on the input device/ file. 

Disk file names on the USER pack (USER n > 0) are prefixed by a slash (/). 
Disk file names on the SYSTEM pack (USER 0) are not prefixed. 

Device names consist of an asterisk (•) followed by the device mnemonic. 

The recognized input device names are: 

*TTC A Console keyboard with parity removed 

•TTiA Console keyboard with parity Intact. 

•CDrA Card reader. For formfeed (FF), punch a 0,2,8 combination in 
any single column. For end-file (EOF) indication, put FF in 
both columns 1 and 2. 

•TP(unit) Magnetic tape. Can be either 9- track, unblocked, EBCDIC format, 
or 7-track, unblocked, BCD format. The "unit" parameter is 
for the first tape drive, 1 for the second, etc. Close parenthesis 
replaces the terminator A . 
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The recognized output device names are: 
»CRT|^ Console display. 
*LPTA Line printer. 
»PCH^ Card punch. 

i 

*TTyA Teletype (printer or paper-tape punch). 

*TP(unit) Magnetic tape; same conditions as for input device. 

*NULA Dummy device; useful if advancing a multiple- file medium 
(usually magnetic tape) past one file out of many. 



Examples: 

To read cards from the card reader and output to the line printer as 
80-column card images, stopping only on encountering EOF card in the card 
deck; 

J[COPyAl£*CDRAO=«LPTA 

To move tape past four end of file marks, guaranteeing a start from the BOT 
(if so desired), for tape unit zero: 

j_REWIND 
JLCOPiAl=«TP(0) 0=»NUL^ 

j.copyAi=»tp(o) o=«nulA 
j_copyAi5*TP(o) o=»nulA 

_!_COPYAl£*TP(0) 0=»NUlA 

To assemble some sourcefile, put the listing on disk (packed), then 
retrieve the same disk file with unpacking of the packed code, putting two 
readable copies on lineprinter and one on tape: 

! MA -AlA LISTING FILE= lp . fllenameA DEF= /def . f ilenam^^ 

INP= sourcefileABIN=sbin.filename/\^ 

ICOPY-UAI5 Ip.filenameAOz. *LPT^ 

J_COPY-UAli lp.filenameAO= «LPTA 

J_COPY-uAl= lp.filenameAo= «TP(0) 

NOTE: COPY does not support Cartridge Tape drives as input or as output 
devices. 
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COPYD 



COPYD copies data from one NCS disk file to another disk file. The 
transfer Is done on a sector by sector basis making it much faster than 
COPY. 

Format: J^COPYDA 1= source- filename A O=destination-filename 

source-filename the NCS disk input file 

destination-filename the NCS disk output file 
Disk file names on the USER pack are prefixed by a slash (/). Disk file 
names on the SYSTEM pack are not prefixed. 

Example: 

!C0PYDAI=WIA 0=/30AA 
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DISCART 

DISCART copies NCS disk files to cartridge tape. These files can be copied 
back to disk using the BUILD utility. 
Format: _iDISCARTA 

CART TAPE UNIT NUMBER = unit-number A 
TRACK NUMBER = track-numberA 
START AT FILE = file-marks-to-be-skipped( * 



FILENAME = filename A 

ENTER DATE (mmddyy) = date A 

(* or + entered) START AT FILE = file-numbergj* 
( A entered) ! >+ 



unit- number 

track-number 

file-numberg 



filename 



date 




cartridge tape unit number or 1 

track number 0, 1, 2, or 3 

number of physical file marks to be skipped over to 
position the tape for writing. Each file is terminated 
with two file marks. To write multiple files, the 

starting file numbers would be 0, 2, M 

* skip past specified file marks - do not rewind before 

or after the write. After the file is written, the 

next starting file is requested. 
+ Rewind, skip past specified file marks - do not rewind 

after the write. After the file is written, the 

next starting file is requested. 
A Rewind and skip past specified file marks. Rewind 

after the file is written and return to NCS. 
- Rewind and return to NCS. 

name of file to be written. USER file nsimes are prefixed 
with a slash (/). SYSTEM file names are not prefixed. 

the date. May be any six digits. 
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Any entry can be cancelled by entering ESC. The prompt is then 
re-displayed requesting the entry. 

DISCART writes the address and size parameters of the file into a header 
record which is read and used by the BUILD utility. 
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EXEC 



EXEC replaces operator key-ins with oharaoters from a unique disk file, 
named COMMANDS (pseudonym W. This permits automatic entry of prerecorded 
commands and responses, at maximum speed. 
Format: J^ EXEC A 

EXEC copies characters from the COMMANDS file into upper memory, as one 
complete block. Then it switches the NCS character-inputter, from 
console-keyboard reading, to reading of this buffer, and turns control 
back to NCS. When NCS next obtains commands and responses, these will 
therefore come from the memory-buffer copy of what had been in disk file 
COMMANDS. When EXEC's buffer-reader can read no more characters for NCS, 
it restores NCS such that reading of command characters is switched back to 
the console keyboard. 

RESTRICTIONS: EXEC code and the memory buffer appear at the emulated-NOVA 
memory locations 40000-4iH77 octal. Any program that writes in this area 
can clobber the action of EXEC; e.g. as with symbol tables for large 
assemblies under the microassembler utility program MA. The file named 
COMMANDS can have maximum length of lOg disk sectors, i.e. at most 
512^Q •S. =4096-Q characters will be copied to the memory buffer. 
Finally, EXEC expects this file to begin on an exact cylinder boundary, 
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i.e. sector address of zero. Any installation finding that EXEC 
malfunctions, should investigate whether COMMANDS has been moved— as often 
done to disk files during compacting of unused directory space. Use the 
FILES utility program to verify location and, if necessary, relocate the 
file named COMMANDS via "Change" parameters 

ADR= cyl A sect A length A 
with length < lOg, sect=0 (always), and cyl=any convenient position. 
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EX 



EX performs somewhat like EXEC, but with certain improvements. The disk 
file which is to be read in, and which must already contain commands and 
responses for execution, is named in the initial dialog. 
Format: 2 ^^^ filename A 

The named disk file again has a length restriction; however, this is offset 

by the fact that several files can chain-link in succession. Example: 

J_ EXA file 1 A (console command) 

EX A file2A (last command in "filel") 

EX A files A (last command in "file2") 

Because program EX and its buffer are located higher in the emulated-NOVA 
memory, there are fewer occasions where another program clobbers the 
functioning of EX. 

RESTRICTIONS: EX code and the memory buffer are placed at fixed memory 
locations 74400-77734 octal. The named disk file must not overflow a track 
on disk. Its length must be six (6) disk sectors or less; i.e. a maximum of 
512^Q *6=3072-Q characters will be copied from disk to the memory buffer. 
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FILES 



FILES, the file-maintenance utility, reports the status of file 
directories; and it adds, changes, or deletes individual file name-blocks 
within any directory. FILES is directed by keyed-in commands; to prompt 
for these it displays "»" . Some commands have one or two levels of 
subcommands. Each command and subcommand is activated by entry of a 
single-letter mnemonic; the suffix characters are filled in by FILES. 
Other (unabbreviated) parameters are required after some commands and 
subcommands. When invoked, but before accepting the first single-letter 
command, FILES demands entry of a six-digit date code. 

Format: j^ FILES 

FILE DIRECTORY UTILITY. ENTER DATE (MMDDYY) = date 
^ command [ ... subcommand ... ] 

Table 4 summarizes the primary commands by initial letter, their 
completion (filled in by FILES), and functioning. For A, C, and D, after 
filename parameters the ellipsis •'..." indicates subcommands. Table 5 
specifies secondary and tertiary commands; these are the subcommands 
needed under primary commands A, C, and D. Only A and C allow multiple 
subcommands; only under secondary command TYPE are there tertiary 
commands. Termination of a multiple-subcommand sequence depends on level. 
Enter ":" to terminate the tertiary command sequence; enter "G" (GO) to 
terminate secondary ones. Table 6 names all parameters of the file 
name-block. Under commands PRINT and REPORT . parameters are displayed for 

2-24 



all files. For commands A, C, and D, file-parameters display before the 
user can command the finalization. The checksum parameter is created by 
FILES; all other parameters are enterable under command A. 
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Table U. Single-letter (») Commands, accepted by FILES: 



*_ Display after Completion Notes 

E END OF JOB 1« 

V VOLUME NR. (OCTAL.0-1 1 ) ; nn A 2. 

R REPORT ON mmddyy . VOLUME NUMBER nnnn 3 . 

P PRINTING REPORT '^• 

A ADD (NEW FILENAME; ) cccccccccc A ... 5. 

D DELETE (ENTER FILENAME;) cccocccccc A ... 6. 

C CHANGE (ENTER FILENAME;) cccccccccc A ... 7. 

U UNUSED ON THIS VOL.= 8. 

L L .CUTOFF= nnnn A 9. 

N N AME-SUMMARY 10. 

S S EARCH (ENTER SUBSTRING OR FULL NAME); cccccccccc A 11. 

T TOTAL-DISK SEARCH (ENTER SUBSTRING OR FULL NAME); cc.cA 12. 



Notes: If instead of the initials above, a "control" key (low-valued ASCII 
codes, including standard "separator" characters) is entered, it is 
ignored and FILES restarts the command entry. Exceptions are initial CR 
(outputs an extra LF and then restarts); and an ESC character anywhere in 
the string (terminates current command or subcommand, restarts entry of 
another complete command). Ellipses "..." above indicate where 
subcommands are expected. 

1. Forces an exit. FILES terminates; N.C.S. obtains control. User number 
remains set to value for last Volume command, or to its value at entry to 
FILES if no Volume command was given. 

2. User is to enter "nn" as a one or two digit octal number, where nn=1 up 
to upper limit implies some "user volume", while nn=0 implies the "system 
volume". Upper limit, indicated here as eleven, becomes M in the case of 
"split pack" configurations. 

3. Here FILES itself displays the date "mmddyy" (entered by user when 
FILES was invoked), and the octal volume number "nnnn" (last entered by 
Volume command). After the line shown, there follows a line of column 
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headings, and then full directory display on successive lines. To stop at 
the end of a line currently being output, hit any key; when thus stopped 
hit ESC to terminate the Report command at that point, or hit any other key 
to continue. 

4. This display, on the console CRT, is followed immediately by output to 
lineprinter of items under command R and Note 3. 

5. The symbols cccccccccc indicate that a 1-10 character filename 
parameter must be entered. It should not exist already in the directory of 
the selected Volume (else an error message will be displayed). If no 
error, after the filename entry FILES waits for entry of subcommands and 
parameters per Table 5. 

6. Again a 1-10 character filename parameter must be entered. This 
filename must already exist in the directory (else an error message will be 
displayed). After the filename, to confirm deletion enter subcommand Y 
(Table 5); to avoid deletion enter any other character (usually CR). 

7. Conditions as per Note 6. Parameters as per Note 5. 

8. The U command displays only the "unused" areas, abstracted from the 
display produced under the Report command. 

9. Determination of what is meant by an "unused" area, under the R, P and 
U commands, is complicated by the fact that large pseudo-files can be 
defined so as to overlap several smaller genuine files, including unused 
spaces between the small files. A "cutoff" value of file length is used, 
for decision as to whether to display an unused area. The default cutoff 
length is 2200 octal. Any area will be prevented from reporting as unused, 
if it is overlapped by any existing file of length in sectors less than 
this cutoff value. Use the L command to enter a new cutoff length (any 
octal value from 1 to 22600). 

10. Displays the filenames of the current directory, packed eight per line 
of the 80-character CRT line. All other parameters from the directory are 
dropped, in an attempt to display all or most names from one directory on a 
24-line screen. 

11. The symbols cc.c indicate that the user is to enter 1-10 characters 
representing all or part of a filename whose existence is in question. 
Directory of current Volume is scanned, and each full filename compared to 
see whether it fully matches the inputted name, or the inputted substring 
can be embedded in the full name. Any successful matches are displayed, 
seven per line on the CRT. 

12. Same parameter entry as for command S, Note 11. Here all volumes are 
scanned in descending (wraparound) order, so as to end at the current 
Volume Number. For each volume, the output displayed is that described in 
Note 11. 



2-27 



Table 5. Subcommands (») accepted after certain Commands: 

* Display after Completion Notes 

...for DELETE command... 

Y y 1. 

...for ADD or CHANGE command... 

A ADR = cyl A sect A length A J. 2 . 

T TYPE = code^ [a code2 I A code3] ] : 3. 

P PROGR = load-pt.A pgm. length A entry-pt A £ 4. 

G GO 5. 

: : 6 . 

CR (Carriage Return) LF (Line Feed) 7. 

NOTES;: If instead of the above subcommands (secondary commands, in 
leftmost column, and tertiary commands, under the Type secondary command), 
what is entered for the initial letter is a "control" key (low-valued ASCII 
codes including the standard "separator" characters), then this initial 
character is ignored and FILES restarts the reading of the particular 
secondary or tertiary command. Exceptions are: initial CR (first produces 
an extra LF output, then restarts); and an ESC key (given anywhere in the 
string, this terminates the current secondary or tertiary command, and 
restarts entry of another complete primary command). 

1. Unlike all other subcommands, here a CR will not give approval for 
completion to take place (deletion of filename from the directory). To 
make it more difficult to err, only if an upper-case Y is entered will 
deletion be approved. 

2. Subcommand A needs three octal numbers as parameters; after the third 
standard terminator character, FILES outputs a ":" to indicate acceptance 
of the input. The first two parameters must represent a legal starting 
location for the desired file (for sect use octal values 0-27). The third 
parameter must represent a legal file length in sectors (octal values in 
range 1-22600 for the N9755 disk). 

3. Subcommand T is a secondary command and the codes are treated as 
tertiary commands; each is input as a single letter, chosen from this set 
of six characters: 

R,W; D,P; N,E; 
where R,W are mutally cancelling, likewise for D,P and for N,E. 
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Completions and meanings for these tertiary commands are: 

READ File is to be wrlte-inhlblted (default). 

WRITE File is to be wrlte-enabled, under N.C.S. utilities 

DATA File is to contain "data", i.e. not a program (default). 

PROGR File is to contain an invokable program under N.C.S. 

NO-EXEC File not executable if a program; i.e. N.C.S. after loading, 
will not obey the entry-pt parameter (default). 

EXEC Invocation starts execution after loading; uses entry-pt 
pareimeter (entered under secondary command P of Table 5). The 
N.C.S. invocation function (Ifilename) uses this address 
regardless of any start-address given during assembly of the 
program itself. 

Since these tertiary commands can be given in any amount and any sequence, 
the standard separator merely prompts FILES to expect another such 
command. Thus, to escape from this string of tertiary commands back to 
secondary commands, a different character, ":" , is needed. This is one of 
two cases where the user enters a colon. 

4. Subcommand P needs three octal numbers as parameters; after the third 
standard separator character, FILES outputs a ":" to indicate acceptance 
of the input. If elsewhere the user has specified Type=Data, then the 
three parameters are not interpreted by N.C.S. If however Type=Progr, then 
per Table 5 the three parameters will represent two absolute locations and 
one program length (words), of a presumed NOVA core image program defined 
in 16-bit binary words. In this case the "! filename" invocation under 
N.C.S. is allowed to load the specified number of words, starting at the 
specified absolute address in emulated NOVA memory. If it is true not only 
that Type=Progr, but also that Type=Exec, then this invocation function 
will, after completion of loading, begin execution at the indicated 
entry-point (absolute address). 

5. GO indicates that the user has finished specifying the file's 
description or alteration. On receipt of Go, FILES will display the 
complete set of tentative file name-block parameters (see Table 6), with 
warning messages (if any), for approval. Warning formats are: 

EXTENT OVERLAP ON FILE filename 

6. The user may enter a colon, ":" , after the Note 5 display has 
completed, if he has observed a mistake and wishes to change the 
parameters. This is the second of two cases where users enter colons. 

7. The user may enter the CR (carriage return) after the display of Note 5 
has completed, to command FILES to accept the alteration of parsuneters of 
an old file, or the installation of a new file. 
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Table 6 File-block Parameters: 



Parameter Definition 

filename a name of one to ten characters, unique to this volume's 
directory, and not embedding any of the standard separator 
characters (period, space, etc). 

date Any six digits; recommended as latest upgrade date. 

cyl Starting disk-cylinder address (octal) for the file. 

sect Starting disk-sector address (octal, 0-27). 

length Octal length of file in sectors, where each sector can 
hold (in emulated NOVA as used under N.C.S.) 400g words or 
lOOOg characters. 

type File type/access information (per Table 7). 

load-pt. Meaningful only for Progr files, an absolute address load 
point (octal) for the program. 

pgm. length Octal number of 1 6-bit words in the program, used along 
with load-pt when loading, and meaningful only for Progr 
files. 

entry-pt. Octal entry point, as an absolute word address, used by 
N.C.S. as the next point to which to transfer control 
after completion of loading, but only if the file has been 
declared both Progr and Exec type. 

checksum A file-block validation word (octal sum of all other 
parameters), made up automatically by FILES. 



Comments: These parameters are displayed in a single row, for one file, 
after a "G" (GO) subcommand is entered under ADD, CHANGE . or DELETE. 
Multiple rows of these parameters, representing all files in the current 
volume's directory, are output under REPORT and PRINT. Numeric fields (all 
parameters except filename) are displayed in octal, as either 6, 4, 2 or no 
digits; i.e. length of 22654 is displayed as 02265M, while value zero is 
displayed as a blank field. The "type" code, reported as a two-digit octal 
number, represents the pattern of four bits described in Table 7. 
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These bits are retained in a separate 1 6-bit word within the file 

name-block group, as bits 12-15 (NOVA convention). All other bits of this 
word are reserved. 

12 13 1^ 15 




3 



This example shows a bit pattern, displayed as octal 11 by FILES, with 
meainings: write-enabled; contains data; is on User 0. 

Table 7. Type-parameter Bit Assignments: 



Binary- Bit- 
pattern nr. Function 

0001 15 1 = File is write-enabled. 

= File is read-only; any attempt to write on it 
should produce an error condition. 

0010 ^^ 1 = File contains program, loadable into emulated 

NOVA memory (QM1 mainstore). User key- in of 
filename, after the "!•• prompt, activates the 
N.C.S. invocation function, which accepts 
parameters described under PROGR subcommand. 
The load-pt tells it where the destination area 
begins in memory. The length tells it how many 
1 6-bit words to copy into one contiguous region. 
These parameters are also needed by the "$" 
utility which must have been invoked (!$filename) 
to have copied the absolute core-image program, 
from mainstore to disk file in the first place. 

= File contains data only (non-program). The 

absolute address and length fields are meaning- 
less to the N.C.S. invocation function (although 
they may be user defined for other purposes). 

0100 13 1 = Allow the N.C.S. invoker to transfer control, 

after loading, to the absolute address given as 
entry-pt parameter under the PROGR subcommand. 
This bit is set by EXEC, cleared by NO-EXEC 
tertiary commands. For N.C.S. to obey this 
transfer of control, the previous bit (pattern 
0010) must also have been set. 
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Binary- Bit- 
pattern nr. Function 

= Prevent the invocation from transferring control 
after loading; instead, control returns to N.C.S. 

1000 12 1 = Cause file to be obtained from SYSTEM pack. 

= Cause file to be obtained from the USER pack 

(whichever volume last selected for Volume command 
or, external to FILES, by !USER.) 
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FREE 



FREE displays the graphic FREE on the CRT. 



Format: !FREE A 
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LD 



LD loads a NOVA binary program into mainstore from a disk file, and 
optionally starts execution of the program. 



Format: J[LDA [•]filename[+nnnnnno] A 
filename 



+nnnnnn, 



8 



the disk-file holding microassembler output of a 
NOVA program. The output is received in a QM-1 
format and LD reformats it into NOVA format binary 
as it is loaded into mainstore. 

indicates that the file is not to be executed. 

offset the load address by this value. 



If the file does not contain a start address block or if the * option is 
used, control is returned to NCS; otherwise control is passed to the loaded 
program at the address in the start block. 
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MAP 



MAP prepares an executable NANO binary program from the nanoassembler 
output of a nanoprogram source. 

Format: JMA^A 

INPUT FILE= input- filename A 

OUTPUT FILE= output-filename A 

nnnnnng SECTORS IN. nnnnnn^ SECTORS OUT 



input-filename 



the input to MAP is the binary 
output of a NANO program assembly 
by the nanoassembler. 



output-filename 



the executable NANO binary 
program output by MAP. 



Error Message: 

If an Invalid file is specified, the following message is displayed. 

FILE INCOMPLETE. RESTARTING 

INPUT FILES 
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NOVA MEMORY DDMP PROGRAM 

The NOVA memory dump progrsim is a location independent program that dumps 
NOVA memory to the line printer. Current invokable verlsons of the NOVA 
dump program are called D1000 and D15100. The name incorporates the load 
point of the dump program. The dump program occupies just under 700- 
mainstore locations. 

Format: _[D1000 A 
or 
J.D15100A 
DUMP FROM: start-address A TO: end-address A 

The contents of all locations from start-address to end-address are dumped 
to the line printer in octal, hexadecimal, and ASCII, as shown in Figure 1. 
In the octal dump, all-zero words are depicted by six dashes rather than 
six zeros. In the ASCII dump, lower case ASCII characters (greater than 
140) are printed as upper case. Special symbols (less than OUO) are 
printed as underlines. 

When the dump has been printed, pressing any key causes the DUMP FROM; 
prompt to be displayed, and new bounds may be entered. 

A file containing the dump program loadable at any other desired location 
in memory can be created using the procedure, HOW TO PREPARE AN INVOBCABLE 
NOVA PROGRAM, described in Section 2. 
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The new file directory entry has a new file name, location parameters that 
overlap D1000, and program parameters specifying the new loadpoint and 
entrypoint (entrypoint equals loadpoint) and the length (700q words). 

The NOVA dump program may be invoked by an executing NOVA program, as 
follows: 

Load the start and end addresses into AGO and AC1, then store them in the 
address array in the dump program. START represents the load/entry point 
of the dump program in this procedure. The dump program is activated by 
entry to START + 2. 



LDA 


2,ADRST 


LDA 


3,3,2 


ADD 


2,3 


STA 


0,0,3 


STA 


1,1.3 


LDA 


3, ADRST 


JMP 


2,3 


ADRST: 


START 



; START ADDRESS OF DUMP PROGRAM 

; FETCH ADDRESS ARRAY DISPLACEMENT FROM START 

{GENERATE ADDRESS ARRAY LOCATION IN AC3 

; STORE FIRST ADDRESS TO BE DUMPED 

; STORE LAST ADDRESS TO BE DUMPED 

; START ADDRESS OF DUMP PROGRAM 

;JMP TO START + 2 

; ADDRESS OF DUMP PROGRAM 



When the specified dump has been produced, the dump program jumps to the 
keyboard interrupt routine. If control is to be retained by the calling 
program, location START must be modified to execute a jump back to the 
calling program. The following instruction sequence may be used: 
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LDA 


2, RETRN 


; RETURN ADDRESS 




STA 


2,7 


;SAVE IN LOW CORE 




LDA 


2, ADRST 


; ADDRESS OF DUMP PROGRAM 




LDA 


3, INSTR 


; RETURN INSTRUCTION 




STA 


3,0,2 


; PLACE AT START 




JMP 


2,2 


;JUMP TO START + 2 


RETRN: 


GO. ON 




; RETURN ADDRESS 


INSTR: 


JMP 


§7 


; RETURN INSTRUCTION 


ADRST: 


START 




; ADDRESS OF DUMP PROGRAM 


GO. ON: 


»* 




; RETURN HERE 



2-38 




, - ir o <■» <T 
o o o « •- 
M ^ 3iO in ^ 

m <■ ejo •« o 

.-li m O O <T -T 

I ,. o o o o o 



<n 4 O c O 
« ro O I- rvi 

(>. .. (s\r- a 
o ^ '"■lo •*■ 
o o o|o •■ 



L« O tn r* fn f'^l^x O 
in s >n o 3 »p '" 

O -r *!'>' <» ilo *? 
O 'J •* O O * "• !$ 

o o Ola o OH » 
.•M J X* h* J^ ■">' p £ 

rg » u^l-< "J - S ^ 



w o (ft o m •« into e ^ 

3 0'^ 2>P O 'IP 2 ? 

* 3 mi-i- 3 '^1''* '^ 2 i 
O ^ mU e olrg ni Cla 



P» 3 •«! 

o o o 



>■ rv S 

o »• -• 



O <!' 

m c 
.« e 



g3JS5'V!0~~|nc 



23S0 53 33333-O 



3 O 3 O OiO O 3 O 3 g 
S OIO O 3IO O OlO O 3 




3 3 

r- c 
^ r- 

8 O 



2-39 



PREP 



PREP prepares a loadable file on cartridge tape from program files on disk. 
The program files can be nanostore, control store, and/or mainstore files. 
The PREP'ed file can be loaded into the three storage regions by selecting 
the track and file with the F-switches. Automatic initialization and 
initiation can be performed by the IML function if the PREP'ed file is 
terminated by a start record. The start record specifies the initial 
conditions for execution and the disposition of the cart tape. 



Format: 



unit-number 



track-number 



! PREP A 

CART TAPE UNIT NUMBER = unit-numberA 

TRACK NUMBER = track-number [^] 

cartridge unit number 

first unit = 0, second unit = 1 



Track on which load file is to be PREP'ed 
• Do not rewind the cart before processing. 

PREP is directed by a set of commands, each performed in the sequence in 
which they are entered. The commands are described in Table 8. Any string 
may be restarted by entering ESC. 
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Command 
#P 

m 

PROCESS = PROGRAM = OWNER = YY.MM.DD 
HH.MM.SS = COMMENTS = 



Definition 

skip over an existing file on the 
specified track. One file is skipped 
for each P command. 

enter header record. The header format 
is displayed but no entries are expected. 
This is currently a dummy record. 



#C 

PRESET CODE (NANOSTORE.CONTROLSTORE . MAINSTORE) 

FROM nnnnnng/^ TO nnnnnng A VALUE ; set-valueA 



m MAPPED NANOCODE FILE NAME = filename A 



M ) clear the specified 
C ? memory region within 
N ) the specified range and 
^ set each location to the 
specified value. 
M = mainstore 
C = control store 
N = nanostore 
Mainstore and control store addresses 
are word addresses. Nanostore 
addresses are byte values with the 
word address in the first digits and 
the byte address in the last two 
digits. 



load one absolute mapped nanocode 
object file to the tape. 



#M MICRO BINARY FILE = filename 



-offset 
« 



#V NOVA BINARY FILE = filenameA 



#Q m-^ MAINSTORE FILE = filename 



#1 



A load one control store file to the 
tape. Optionally, offset the 
loadpoint by the plus or minus 
value given, or set the loadpoint 
to the value if * is selected. 

load one 1 6-bit format mainstore 
file to the tape. 

T 

-offset A^°^^ °"® 1 8-bit format mainstore 
file to the tape. Optionally 
offset the loadpoint by the plus 
or minus value given, or set the 
loadpoint to the value if * is 
selected. 

Interrupt the current PREP and 
return to NCS. (Usually used to 
change USER number.) 
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tf START CODE (HARDSTOP.NANOSTART.MICROSTART 



$ 



REWIND? 



i'-] 



SKIP TO EOF? / 
START ADDRESS 



#W 



#R 



!} 



prepare and load a start 

record on the tape. 

H = hardstop; no automatic 
entry - must use read- 
only program with F-switch 
selection to start. 

N = nanostart; direct transfer 
to nanostore. 

M = microstart; loads all 
QM-1 registers from the 
microstart array and 
directs transfer to 
control store. 

Y = the read-only boot program 

will rewind the cartridge 
after loading. 
N = no rewind after loading. 

Y = causes a skip to EOF. 
N = no skip to EOF. 



nanostart or microstart address A address at which to start execu- 
tion of the loaded program. 

write one end of file on 
the tape. 

rewind the tape. Another 
track may be selected. Press 
ESC if no track is desired. 



#EXIT FROM CART PREP 



»E 



terminate PREP. Write one 
end of file and rewind the 
cart tape. 

return to NCS. This command 
may only be given after #E. 



Table 8. PREP Commands. 
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Error Messages: 

If the specified file is not found, the request for filename will be 

repeated. If the file is not a valid binary file, the following message is 

displayed: 

FILE INCOMPLETE. RESTARTING. 

The prompt character # is displayed, requesting a new command. 
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PREPD 



PREPD prepares a loadable file on NCS disk from program files on disk. The 

program files can be nanostore, control store, and/or mainstore files. The 

PREPD 'ed file can be loaded into the three storage regions by selecting the 

file with the disk bootstrap. Automatic initialization and initiation can 

be performed by the IML function if the PREP'ed file is terminated by a 

start record. The start record specifies the initial conditions for 

execution. 

NOTE- PREPD writes 18 bit output files on disk. These files cannot be 
saved or restored with nomal NCS utilities. 

Format: j_PREPDA 

FILENAME = filenameA 
filename The file to which the information will be written. 

Disk bootstrap functions thus (if the QH~^ DLSP switch is on): Pressing 
buttons MC (master clear), START, produces the display 

???LD 
on the console CRT. Operator completes the command by entering the above 
filename without a prefixed slash if the file is on User 0, or by entering 
n/ filename if the file is on User n. 

PREPD is directed by a set of commands, each performed in the sequence in 
which they are entered . The commands are described in Table 8.1. Any 
string may be restarted by entering ESC. 
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Command 
#P 

m 

PROCESS = PROGRAM = OWNER = YY.MM.DD= 
HH.MM.SS = COMMENTS = 

#C 

PRESET CODE (NANOSTORE . CONTROLSTORE . MAINSTORE = 

FROM nnnnnngA TO nnnnnng A VALUE ; set-value A 



#N MAPPED NANOCODE FILE NAME = filename A 



#M MICRO BINARY FILE = filename 



+ 
-offset 



#V NOVA BINARY FILE = filename A 



#Q QM-1 MAINSTORE FILE = filename 



-offset 



£L PROCESS = PROGRAM = OMER = YY.MM.DD.: 
HH.MM.SS = COMMENTS = 



Definition 

skip over an existing file on the 
input. One file is skipped for each 
P command. (Not yet operational) 

enter header record. The header format 
is displayed but no entries are expected. 
This is currently a dummy record. 

Mj clear the specified 
C I memory region within 
N )the specified range and 
set each location to the 
specified value. 
M = mainstore 
C = control store 
N = nanostore 
Mainstore and control store addresses 
are word addresses. Nanostore 
addresses are byte values with the 
word address in the first digits and 
the byte address in the last two 
digits. 

load one absolute mapped nanocode 
object file to the output file. 

load one control store file to the 
output file. Optionally, offset the 
loadpoint by the plus or minus 
value given, or set the loadpoint 
to the value if * is selected. 

load one 1 6-bit format mainstore 
file to the output file. 

A 

load one 1 8-bit format mainstore 

file to the output file. Optionally 
offset the loadpoint by the plus 
or minus value given, or set the 
loadpoint to the value if * is 
selected. 

enter library header record. This 
header will cause the start of a new 
library. 
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#T PROCESS = PROGRAM = OWNER = YY.MM.DD: 
HH.MM.SS = COMMENTS = 



#U USER # = user-numA 



enter trailer block to end a library. 
Causes the boot loader to terminate 
the current library. 

change the input USER number to 
the specified USER. This is a tem- 
porary change, upon exit to NCS the 
USER is set to its value at 
initalization. 



#F INCLUDE FILE NAME = filename A specify a file to be included at 

micro-load time by the IML loader. 
If the specified file is a USER 
file, the current USER directory is 
searched to validate the files 
existance. If it is a SYSTEM file, 
the SYSTEM directory is searched. 
The file itself is not accessed 
until load time, PREPD only writes 
out the name of the file. 

#S START CODE (HARDSTOP. NANOSTART. MICROSTART)= ) N f prepare and load a start 

M ) record on the file 



START ADDRESS = nanostart or microstart addressA 



H = hardstop; no automatic 

entry 
N = nanostart; direct transfer 

to nanostore 
M = microstart; loads all 

QM-1 registers from the 

microstart array and 

directs transfer to 

control store. 

address at which to start 
execution of the loaded 
program. If user enters 
address value 777777, a 
previously-specified START 
address is retrieved and used. 



#W 
#R 
#E 



write one end of file record 
on the file. 

remark all characters up 

to the next (CR) are ignored 

terminates PREPD. Guarantees 
that the file is terminated 
by an EOF, EOI, closes the 
output, and returns to NCS. 



Table 8.1 PREPD Commands. 
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Error Messages: 

If the specified file is not found, the request for filename will be 

repeated. If the input file is not a valid binary file, the following 

message is displayed: 

FILE INCOMPLETE. PREPD ABORTED. 

Control returns to NCS. 
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qULD 



mU) is a m-^ loader that runs under NCS. QMLD can load mainstore, 
control store, and nanostore from program files residing on the current 
USER or SYSTEM packs, thereby initializing and loading the QM-1 for new 
emulator operation. All files must be in absolute binary format. 

The parameters in the QMLD parameter list are positional and are separated 

by NCS delimiters. As each delimiter is entered, the preceding files(s) is 

moved into a temporary region of mainstore. The final delimiter entry 

causes the three storage areas to be loaded from the temporary region of 

mainstore. 

Format: _!^QMLDA [•] [$] mainstore-filename [+filename . . .]A 
[»] control store-filename [+filename . . .]A 
[»i nanostore-filename [+filename . . .] A edit-functionA 

• specifies clearing of the storage to zero area before 

loading. 

$ specifies that the file to be loaded is in 16 bit binary 

format from the microassembler (i.e., NOVA format). 

+(or &) specifies that the next file named is to be loaded into 

the storage region in addition to the first file named. 
Files are loaded in the order specified. 

mainstore-filename mainstore program file to be placed at 20000g-33777g 

of mainstore for residence at to 13777g. 

control store-filename control store program file to be placed at 60000g-77777o 

of mainstore, for residence at to 17777g of control store. 

nanostore-filename Mapped format nanostore file to be placed at 36474o-57777g 

of mainstore (see MAP command), for residence at 000 to 
67423 of nanostore. 

edit-function one of a set of functions that can alter the object code 

and select loading and execution. The edit functions 
are defined in Table 9. 
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edlt-functlon 

stA 

ST(nnnnng)A 
GO A 

GO(nnnnng)A 
RANGE nnn^TO nnn^ 



T1 
T2 

T3 
TM 

END 



definition 

load MS 00000j5-i3777g from 20000q-337778 of MS 
load OS 00000^- 17777o from eoOOOg-TTTTTo of MS 
load NS OOOOOg-006748 from 36474q-577778 of MS 

performs LD function and MICROSTART's at CS(IOO) 

performs LD function and MICROSTART's at CS(nnnnng) 

performs LD function and NANOSTART's at NS(0) 

performs LD function and NANOSTART's at NS(nnnnng) 

input NS address range for generating T-step stretch 
commands. The default is 0-777 

stretch the specified T-steps(s) in all nanowords 
within the current RANGE. 

terminate C^D without loading or execution. 



Table 9. Edit Functions of (M.D 



Error Messages: 

If the emulator is locked (see p.U) QMLD will halt instead of starting the 

loaded programs. Enter (s) S4 17777 and reenter the QMLD command. 



Switches : 

If the "PROGRAM STOP" switch on the console is ON when the ST or GO command 
is given, the m-^ will HALT before entering the user's program. SINGLE 
STEP, DOUBLE STEP or MICRO STEP can then be selected by the user. 
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RESTORE 



RESTORE copies to disk a file that has been stored on magnetic tape with 
the SAVE utility. 
Format: J_REST0REA 

MAG TAPE UNIT NUMBER = unit numberA 

START AT FILE = [ (s) SIOOHOO] file-marks to be skipped 
LOAD FILE = file-name 
DATE OF HDR = date 
VOL NUMBER = volume 
START CYLINDER = cylinder 
START SECTOR = sector 
FILE LENGTH = length 
HIT (RETURN) TO WRITE DISK CR 




unit-number 



(s) S100U00 



»» CAUTION »• 

file-marks- to-be- 
skipped 



magnetic tape unit number 

first unit = 
second unit = 1 

switch setting to disable header comparison between 
the saved file and the file definition in the 
destination directory. The file is written at the 
address specified in the header. 

misuse of this option can cause file overwriting. 

number of file marks to be skipped for positioning. 
There are two file marks after each file. To read 
multiple files, the starting file numbers would be 
0, 2, 4 .... 
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* skip past specified number of file marks - do not 
rewind before or after the read. After the file 
is read, the next starting file is requested. 

+ rewind, skip past specified number of file marks - 
do not rewind after the read. After the file is 
read, the next starting file is requested. 

^rewind and skip past the specified number of file 
marks. After the file is read, rewind again and 
return to NCS. 

- return directly to NCS. 

filename , date 

volume, cylinder, file attributes obtained from header record of the 

sector, length SAVE'd file. 

RESTORE will write to an uninitialized USER if the @ SI 00400 option is 

used. Otherwise, the USER must be initialized with the SYSINIT utility or 

a disk error message will be displayed. 



If the (s) S 100400 option is not used, the header parameters are examined 
and the destination directory is searched for the filename. If the 
filename has not been defined, or if the length is too short, or if the 
file is write protected, RESTORE will ask for an alternate filename. The 
alternate filename must have been defined with appropriate parameters. 
The parameter list for the alternate file is displayed followed by 
HIT (RETURN) TO WRITE DISK 

Error message: 

DISK ERROR 
Disk is not ready, or has unrecoverable data error. 
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REWIND 



REWIND positions the magnetic tape or the cartridge tape at the loadpoint. 
Format: J^REWINdA unit-number^ 

unit-number = first magnetic tape unit 
= 1 second magnetic tape unit 



= n nth magnetic tape unit 
= CO first cartridge tape unit 
= CI second cartridge tape unit 
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.s 



.S directs execution of a preloaded NOVA program to begin at a specified 
location in mainstore. 

Format: J_.S _= locationgA 

The dot symbol ( . ) tells the NCS nucleus to load and executes the transient 
program whose name follows. (Each NCS transient program occupies exactly 
one disk sector.) Symbol "S" is the name of one of these transient 
programs. When translent-S is in control, it in turn needs further 
information. Thus, it issues the equal-sign (=) as a prompter. What it 
needs is an octal address value followed by a standard terminator. 
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SAVE 



SAVE outputs an NCS file to 9-track magnetic tape. The file can be 
retrieved and written back to disk by the RESTORE utility. 

Format: _!.SAVEA 

MAG TAPE UNIT NUMBER = unit-numberZ^ 

START AT FILE = f ile-marks- to-be-skipped J + 

FILENAME = filename^ 
ENTER DATE (mmddyy) = dateA 

START AT FILE = file-marks-to-be-3kippedQV+ 

t- 

or 



unit-number 

file-marks-to-be- 
skippedg 



filename 



date 



magnetic tape unit number or 1 

number of physical file marks to be skipped over to 
position the tape for writing. Each file is terminated 
with two file marks. To write mulitiple files, the 
starting file numbers would be 0, 2, 4.... 
* skip past specified number of file marks - do not 
rewind before or after the write. After the file 
is written, the next starting file is requested. 
+ rewind, skip past specified number of file marks - 
do not rewind after the write. After the file is 
written, the next starting file is requested. 
A rewind and skip past specified number of file marks. 
After the file is written, rewind again and return 
to NCS. 
- return directly to NCS. 



name of file to be written, 
prefixed with a slash (/). 
not prefixed. 



USER file names are 
SYSTEM file names are 



the date. May be any six characters except A . 
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An entire USER can be output with SAVE by defining a file beginning at 
cylinder 0, sector 0, with a length that overlaps all other files in the 
USER. The maximum USER length is 22600q sectors. 

Error Messages: 

WRITE PARITY ERROR. RECOVERED - address 

SAVE continues. 

WRITE PARITY ERROR. UNRECOVERED - address 

To continue, enter ^) G. 

Any entry can be cancelled by entering ESC. The prompt is then 
re-displayed requesting the entry. 

SAVE writes the address and size parameters of the file into a header 
record which is read and used by the RESTORE utility. 
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DISK PACK IHITIATOH (SYSIMIT) 

SYSINIT is used to initialize or re-initialize a disk. A new disk must be 
formatted prior to initialization, as described in Section 3 (HOW TO FORMAT 
A NOVA DISK). 

Initialization of a new disk prepares the directory. Individual files can 
then be defined using the ADD command of the FILES utility. Files may be 
placed on disk using the COPY utility. The contents of an entire disk 
platter (output of the SAVE utility) can be copied onto an initialized or 
uninitialized disk using the RESTORE utility. 

Re-initialization of an existing disk erases all file names and pointers 
from the directory. Each USER is viewed by NCS as a separate disk and each 
is initialized separately. 

CAUTION ! 

Improper use of SYSINIT may cause permanent loss of files on the 
disk. Therefore, the use of SYSINIT is intentionally complicated. 

This procedure assumes that the proper USER assignment has been made by 
invoking USER. 
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Format: _!^LD,GPOA 

1LD,=SYSINIT=?A 

NOVA-CONTROL-SYSTEM-INITIATOR 

*WARNING* (UNPROTECTED) CAN DESTROY ACTIVE DISK DIRECTORY 

SYSINIT is now in HALT state. (s) L will allow escape without 
damage at this point. 

^-"^ CsYSTEMZly SYSTEM specifies USER initialized. 

ENTER DEVICE TYPE — / USER A jUSER specifies current user initialized. 

If SYSTEM SYSTEM DISK INITIALIZED 

If USER ENTER VOLUME NUMBER (OCTAL) any non-zero number (up to four digits) 

USER DISK INITIALIZED 

©R 

The disk platter is now initialized. 

The user should now invoke FILES and add a file named DIRVn (where n is the 
USER#) whose address is 0,0,110. This is the space occupied by the volume 
header and the directory. 
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UPDATE 



UPDATE, the line-editor utility, performs deletions/insertions of single 
lines or groups of lines, by line number, while copying sourcecode from one 
file (or device) to another. A "line" is a string of one to 132 characters 
containing exactly one CR which must be the final character; or else a 
string of exactly 132 characters containing no CR (carriage return). 

UPDATE uses four files (or devices), functioning in part like the utility 
COPY with an additional two files (devices). One of these contains input 
for any "control" items (deletion/insertion commands) and also for any new 
sourcecode lines to be inserted. The other contains output for a "report" 
(logging) of all transactions. The old files ("source-in" and 
"source-out") from COPY are retained and line numbers in reference to 
either of those files represent implicit positions within each file 
(device), designated by positive decimal numbers less than 32768. (Zero 
implies "before first line".) 

Format: j_ UPDATeA CTL.IN= controlA LOG.OUT= reportA 

[additional dialog if "report" is a disk file] 

1= source-inA 0= source-outA 
[additional dialog if "source-out" is a disk file] 

When neither of the output names represents a disk file, there is no 
"additional" dialog, and the format may be abbreviated, in the way it would 
be entered into an EX- file: 
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UPDATE A name 1A name2A nameSA name4A 
where namel and nameS represent Inputs (devices or files) while name2 and 
name4 represent outputs (devices alone). 

Any "name" if it is to represent a device (and not a disk file) must begin 

with an asterisk (•). Legal mnemonics are as follows: 

-for- Devices (same meanings as for the COPY utility) 

namel *CDR 

name2 »CRT , «LPT , «NUL 

names *CDR , »TTC , "TTI , •TP(u) 

name4 »CRT , »LPT , «PCH , »TP(u) , *TTY , «NUL 

The "control" file or device (namel) contains lines, each ending with a CR, 
which fall into two categories per contents of column 1 : 

-col.1- Meaning 

not ")" Insertable-sourcecode line, to be copied to the 
"source-out" immediately upon being encountered. 

is ")" A control-line; three subcategories per column 2: 



cols. Later 

1 - 2 fields Meaning (mmm.nnn = decimal integers) 

) I nnn Copy "source-in" from its present postion up 

through its line # nnn , to "source-out". The 
expectation is that insertable lines will follow. 
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cols. Later 

1 - 2 fields Meaning (nimm,nnn = decimal integers) 

) D mmm-nnn Copy "source- in" lines, up through its line # 

mmm-1 , to "source-out". Then read from "source- 
in" but do not copy (hence, delete) its lines # 
mmm through nnn. Separators between mmm and nnn 
can be one or more of any non-digit characters. 
If nnn=mmm then nnn is superfluous; the user may 
omit nnn (and the separators). 

) » Arbitrary. The "*" can be any printable character other than 

"D" or "I". This control line is treated as a 
comment line, to be printed only in "report". 

The "report" device (or file) receives three categories of line: 

(a) Every control line is copied to it, I.e. of the forms 

)D .... 

)I 

)» 

(b) Every line deleted from "source-in" is recorded in "report", with an 
additional prefixing line number (Implicit ordinal position which it 
has on the "source-ln" file or device). 

(c) Every inserted line, newly placed in "source-out", is duplicated in 
"report", with an additional prefixing line number (implicit ordinal 
position which it will occupy on the "source-out" file or device). 



If "report" is a disk file, these items will be recorded in 
packed-sourcecode format, and may (user option) be appended to prior 
contents of this file. 

As indicated in the initial format summary. If either of the two outputs is 

to be a disk file then the invoking command line requires additional 

dialog. (CAUTION: Also be sure that each such output disk-file is 
write-enabled. ) 
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For the "report" disk file, the additional dialog allows the user to choose 
between starting a fresh file, or appending to an existing file; either 

WANT TO APPEND NEW LOG. OUT TO OLD? (Y.N) N 
or 

WANT TO APPEND NEW LOG. OUT TO OLD? (Y.N) Y 

LOG. OUT FILE PRESENT CONTENTS OCCUPIES ww SECTORS. LESS xx BYTES. 

LOG. OUT FILE EMPTY SPACE AVAILABLE IS yy SECTORS. LESS zz BYTES. 

DO YOU STILL WANT TO APPEND NEW LOG. OUT TO OLD? (Y. 



bcsa zz PI 



For the "source-out" disk file, the additional dialog allows users to 
choose packing or non-packing of sourcecode: 



COMPRESS THE OUTPUT? (Y 



^lNL-Cn) 



Examples of special usage; here ZILCH = a totally-empty file: 

(a) Pack an unpacked file, with no insertions/deletions. 
UPDATE A ZILCH A »NULA <unpacked-file>A <newfile>A Y 

(b) Unpack a packed file to view on lineprinter (CRT similarly). 
UPDATEA ZILCH a *NULA <packed-file>A »LPTA 

(c) Merge two short files (one to totally precede the other), t y) 
UPDATE A <f irstfile> A »NUL A <secondf ile>A <mergedfile>A C.^ _) 

(d) Find out line numbers within existing file, for later run. 
UPDATE A <filename>A »LPT A ZILCH A *NULA 
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USER 



USER assigns a specified user as the removable pack. 



Format: _!^[JSERAn 

n = 1 through 9 

n = 



the corresponding user pack is assigned 
as the removable pack. 

The number of the currently assigned 
user pack is displayed. 



To change USER assignments, the system sense switch setting must include 
bit 17 (the high order bit). If an attempt is made to change USER'S while 
bit 17 is not set, the following message is displayed: 

USER n LOCKED 
where n is the currently assigned USER. 

To unlock a USER, change the switch setting to set bit 17. For example: 
(s) S Mnnnnng 



Example: 
i.USER 4 
!USER IS 4 



assigns USER 4 as the removable pack. 

shows the current removable pack assignment. 
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xc 



XC, the "crosscopy" utility, is restricted to disk files which contain an 
equivalent l6-bit-per-word format. 

This utility program violates the restriction honored by most other 
utilities, of accessing only disk files on the SYSTEM pack and on the 
single USER pack most recently selected. 

Format: J[XC[ -options] A 

HROSSCOPY (DISK TO DISK). -USE l6BIT/VfD FI LES ONLY- 
INPUT FILE; 

DISK-UNIT # (0.1): u^A 

VOL.# (OCTAL.O-max): v^ A 

FILENAME = name ^ A 
OUTPUT FILE; 

DISK-UNIT # (0.1); Ug^ 

VOL.# (OCTAL.O-max): Vg^ 

FILENAME = namCgA 
[further dialog before termination] 

Parameters; ,., ^ « 

u , u - single digit currently limited to 

"• ' 2 or 1. 



^ ' ^2 



one-digit or two-digit octal value, in 
the range (0, 11) for full NCS packs, 
or in the range (0,4) for "split packs" 
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name., namep - one to ten-character name; must 

exist in the directory of the re- 
spective Unit/Volume just selected. 
NOTE: There is no slash (/) preceding 
these names, as the Volume number 
suffices to determine whether the 
USER pack or the SYSTEM pack is 
intended. 

Options: U - Unpack the input file: the disk-read subroutine will 

look for any byte appearing to represent packed 
sourcecode character-repeat counts and will replicate 
the characters accordingly. Therefore, do not use 
option-U if copying binary files. 

P - Pack the output file: the disk-write subroutine will 
look for any repeated bytes and will output instead to 
the disk the packed-sourcecode representation for such 
bytes. Also, any embedded null-bytes (but not the 
final padding null-bytes) will be dropped under this 
option. Therefore do not use option-? if copying 
binary. 

V - View the copying process: the file contents, while 
being buffered line-by-line, is also displayed on the 
console screen. Binary files would probably garble 
the screen but should do not real damage here. 

Further Dialog Before Termination: 

1. The symbol [**] , used below in two places, represents a report of 
byte-tallies which will occupy this 4-line format: 

INP.FILE USED: wwl SECTORS, PLUS xxl BYTES. 

UNUSED: yyl SECTORS, PLUS zzl BYTES. 

OUTP.FILE USED: ww2 SECTORS, PLUS xx2 BYTES. 

UNUSED: yy2 SECTORS, PLUS zz2 BYTES. 

2. If copying completes successfully, the Final Dialog is of the form 

3. If the output file overflows, Final Dialog is of the form 

?? ENDFILE ON OUTPUT — COPY INCOMPLETE 

DO YOU WANT TO CONTINUE FOR FULL BYTE-COUNT? 
(Y,N)? 
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The program pauses for response; any response other than "Y" or "N" 
causes the last "(Y,N)?" to be repeated. Response "N" causes immediate 
termination, and XC exits to NCS. Response "Y" causes a continuation 
of input-file reading in order to compute the full output-file size 
required. The above last line, and continuation thereafter, will have 
the format: 

(Y.N)? Y ...STANDBY. PLEASE... 

[here the input file resumes reading in; and if option-V was selected 
then the CRT screen continues to display sourcecode lines or other 
contents of the input file.] 

TO AVOID OVERFLOWING. 

YOUR OUTP.FILE SIZE MUST BE (AT LEAST).. ww2 SECTORS. PLUS xx2 BYTES. 
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ZAP 



ZAP clears NOVA user memory. The NCS nucleus remains intact. 



Format: IZk?^ 
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»and$ 

* and $ are NCS program file manipulation utilities. 
Format: 




• loads an invokable NOVA program file but inhibits execution. 
Execution is then specified by the .S utility. 

$ writes a program core image from core to disk. The PROGR 
attributes of the file select the area of core to be moved to disk. 



In both cases, control is returned to NCS. 
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SECTIOH 3; HISCELLAMEOUS PROCEDORES 

This section Includes procedures for performing tasks that require the use 
of more than one of the utilities described in Section 2. 
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HOW TO PREPABE AN IHVOKABLE HOVA PROGRAM 

NOVA programs can be invoked and executed by typing the program file naime 
once the program has been reformatted by LD to a NOVA format, and written 
to disk. 

A NOVA source program is assembled by the microassembler to produce a 
binary output file. This binary output is in the QM-1 format and is not 
executable. The binary is loaded into mainstore by LD which reformats it 
as the loading takes place. The reformatted binary is now executable. The 
executable core image is then written to disk using the $ command. 

The NOVA program can now be invoked by using the program file name. 

Example: 

I MA. D BF = . INPT =M YSOURCE. BIN = MYBIN. (MYBIN must be write-enabled. ) 
J.ZAP. 
J.LD, MYBIN. 

J.$MYPROG,Y (MYPROG must be write-enabled.)' 

JMYPROG. now will load and execute the program MYPROG. 

MYPROG must have been declared using the FILES utility, specifying the 
appropriate program parameters. 
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Example: 
J_FILESA 

FILE DIRECTORY UTILITY. ENTER DATE (MMDDYY) = 041577A 
» VOLUME OA 

«ADD MYPROG ADR = 600,0,10 ± TYPE = WRITE EXEC PROGR : PROGR = 100, 2400, 300_j_ GO 
»END OF JOB 
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HOW TO FORMAT A NOVA DISK 



Blank (or scratch) disks packs must be formatted for use in NOVA systems 
before they can be initialized. 

1) Mount the pack to be formatted on the N9755 disk drive. 

2) Mount the standard I/O diagnostic cartridge in the cartridge unit. 

3) Load the N9755 disk diagnostic, using the F-switches to select the 
track and file on which it resides. 

4) Respond as specified to the following prompts. 



? CHnA 

? HC24A 

? INTA 

3 SECTOR MODE? N 

STAGGERED ADDRESSING? Y 



specifies the disk channel as n. 

set head count to 2Mo to format entire disk pack. 

request initialization. 

N is for no. NOVA requires a 24 sector mode. 

Y for yes. Provides faster operation. 



When formatting is complete, this message is displayed: 
TEST COMPLETE 

Verification of the surface can be done by writing the entire disk and 
reading it back. The writing is commanded thus: 

2 WTAA requests the entire disk be written. 

N N 

condition parameters 



BYTE MODE? 



ODD START? N 



DATA CHAINING? 



DMA? Y 



■ 
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After the disk has been written, this message is displayed; 

TEST COMPLETE 

The reading-back function is commanded thus: 

2_ B.dk£^ \ requests the entire disk to be read. 

BYTE MODE? N 

ODD START? N 

condition parameters 



DATA VER? Y 



DATA CHAINING? N 



DMA? Y 



after the disk has been read, this message is displayed: 
TEST COMPLETE 

The disk has now been formatted for NOVA use, and all surfaces have been 
verified. The USER'S can be initialized and established. 
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HOW TO LOAD USER (SYSTEM PACK) 

After a disk has been formatted, the system software must be loaded into 
USER 0. This is done by transferring the system from a disk containing the 
desired system to magnetic tape using the SAVE utility, and then 
transferring it to the new pack with RESTORE. Since the new pack does not 
yet have any system software, the old pack must remain mounted until the 
RESTORE utility is ready to write to the new pack. 

The USER filename is ALL. 

To write this file to an uninitialized USER (such as USER 0), the NOVA 
switches must be set to 100U00 as described in the RESTORE descriptions. 
Example: ALL (which overlaps the entire system USER) was written on 
file of a magnetic tape with the SAVE utility. 

J_RESTORE 

MAG TAPE UNIT NUMBER = 0. 

START AT FILE = (s) 3100400 0. 

file attributes are displayed followed by the 

HIT (RETURN) TO WRITE DISK 

•** before the carriage return, mount the new pack *** 
The switches must be reset to NOVA setting (e.g. 417777) after the restore. 

After USER has been established, the other USER'S can be established 
using the system software in USER 0. 
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APPENDIX A; STAND ALOME PROGRAMS 

This appendix includes a description of the function and procedure for 
using several stand alone programs that are useful in conjunction with the 
operation of NCS. 

The following table lists the programs and briefly describes their 
functions . 



Program 

COPYDD 

LSP 

STAND ALONE DUMP 

STATESAVE 



Function 
Copies one USER to another on the same or different pack. 
Provides loader and primitive debug capabilities. 
Dumps mainstore or control store selectively. 
Saves the state of the QM-1 in control store. 



Table A-1: Stand Alone Programs. 
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COPYDD 



COPYDD is a stand-alone program that copies one disk to another, one USER 
to another on the same disk, or one USER to the same or different USER on a 
different disk drive. COPYDD is booted into control store from track 3 of 
the standard I/O diagnostic cartridge or from a USER cartridge prepared as 
explained in the last half of this writeup. Or, from disk via MC, START, 
???LD COPYDD. 



Format: 



device-type 



channel-&-id 
user-number 



1ST A 

SOURCE DEVICE TYPE = device-typeA 

DEVICE ID = channel-&-idA 

USER NUMBER (SOURCE) = user-number ^^ A 

USER NUMBER = unit A 

DESTNATION DEVICE TYPE = device-typeA 

DEVICE ID = channel-&-idA 

USER NUMBER (DESTINATION) = user-number A 

UNIT NUMBER = unit A 

type of disk format. 
9750 2 USER NCS format 
5550 9750 on a 9755 controller 
9755 NCS split extents, 10 USER'S (old format) 
55 NCS non-split extents on a 9755 
360 2-sector mode, 2 USER'S 

Any other entry causes a redisplay of the prompt. 

disk channel number and ID (e.g. 312) 

USER number for selective disk transfers. 



10 



unit-number 



through 9 transfer to/from specified USER/ if 
> 10 transfer to/ from an entire disk_) type 

9755 

disk unit number (0-3) 



0-Aif 

(type 
> 1 }360 



When the destination device unit number has been entered, the transfer 

begins. When the transfer is complete, the prompt character ? is 

displayed. 
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Errors 

If a disk transfer error occurs, there are two recovery options. 

1) press the SPACE bar and the transfer will be tried again. 

2) press any other key and the operation will terminate. The prompt 
character ? returns, and ST will start the request for transfer 
parameters again. 

To discontinue any command string, press ESC. 

Procedure for preparing a COPYDD file on cartridge tape. 

COPYDD:S is the source program in microcode residing on USER 7 of the NCS 
disk. 

1) Assign USER 7 as the removable pack. 

2) Define a file for the binary form of COPYDD on the system pack, USER 0. 

3) Assemble COPYDD:S with the microassembler using SYSDEF6 as the 
definition file. 

4) PREP COPYDD onto the cartridge tape using MULTI6 as the nanosystem, and 
the binary file for COPYDD plus /M2DSPLAY:B as the micro binary files. 
Use lOOg as the start address. 

COPYDD can now be booted into control store using the F-switch settings to 
select the track and file. 
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LSP 



LSP is an interactive Loader Services Program that provides selective 
loading and debug capabilities in a cartridge tape environment. 

LSP resides in 2400o words of control store. It is relocatable and can be 
loaded at any user-specified loadpoint, allowing it to be loaded in 
addition to other programs already in control store or to be loaded by LSP. 

LSP is capable of: 

1) communicating with a user through the system console. It accepts and 
executes the various commands entered by the user. 

2) loading programs from the cart tape unit. 

3) stretching nanostore T's as nanostore is loaded from a cart tape file. 

4) writing directly into control store, mainstore, and nanostore. 

5) displaying control store and mainstore on the system console. 

6) direct execution of a loaded program via a microstart or nanostart. 

This writeup is devided into two procedures. The first explains how to use 
LSP, and the second explains how to prepare a cart tape file containing 
LSP. 
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How to Use LSP 

LSP is booted into memory from the PREP'd cart tape file using the F-switch 
setting to select the track and file. When loaded, the LSP prompt ??? is 
displayed on the CRT. 

Once started, LSP remains in control until the user gives a command which 
either passes control to an already loaded program or loads a program and 
passes control to it. 

LSP retains control after loading a file from a cart tape when either of 
two conditions is encountered: 

1) A physical end of file is read from the cart tape. 

2) A start record is encountered on the cart tape and the G parameter of 
the LD or LU commands was not specified. In this case, LSP saves the 
address supplied in the START record for a future GO command. 

The LSP command set consists of 21 commands. The following table lists the 
commands and their functions. 



C Display control store 

CO Clear control store 

CM Clear mainstore 

CN Clear nanostore 

DC Display control store 

DM Display mainstore 

DS Define stretch patch 

EC Set control store 

EM Set mainstore 

EN Set nanostore 

GO Microstart 



LD Load and modify 

LU Load unmodified 

M Display mainstore 

MS Microstart 

NS Nanostart 

R Stretch T's in range 

SC Set control store 

SM Set mainstore 

SN Set nanostore 

T Specify T's to be stretched 



Table A-2: LSP Command Set 
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The LSP command format consists of a command mnemonic followed by a set of 
parameters that selectively define the command. The parameters are 
separated by a delimiter which is any character other than an octal digit. 
In this document, the slash is used to indicate a delimiter. The first 
delimiter following a command mnemonic is optional, but if entered, must be 
a slash. 

The command terminator is one of three characters: blank, carriage return, 
or period. The terminator is indicated by a A in this document. 

Characters are entered into the command buffer as they are keyed in. 
Errors can be corrected by backspacing (pressing the backspace key) to the 
error position, making the correction, and spacing forward (pressing the 
space bar) to the end of the line. The space is a terminator only if 
entered at the end of a command. If entered in the middle of the command 
string, the space skips over the character already entered and leaves it 
unchanged in the buffer. ESC cancels the current command string and clears 
the display. 

All addresses and numeric values are in octal, both on input and output. 

After each command is executed, the LSP prompt ??? is redisplayed. 

The following table lists the commands, their formats, and their 
functions . 
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Command 



Function 



11? [D] C[/l start-address/niimber-of-wordsA 



??? [D]M[/] start-address/number-of wordsA 



111CC[/] start-address/end-address/ valueA 



11?CM[/] start-address/end-address/ value A 



???CM[/] start-address/end-address/ valueA 



??? 



(lO 



Display control store beginning 
with start-address and con- 
tinuing until the number-of- 
words has been displayed, 
8 words per line. 

Display mainstore in the above 
format . 

Set all control store locations 
from start-address through 
end-address to the specified 
value. 

Set all mainstore locations from 
start-address through end-address 
to the specified value. 

Set all nanostore locations from 
start-address through end-address 
to the specified value. 



[/] start-address/valueo [. 



, ../valueklA 

Set consecutive control store 
locations beginning with start- 
address through start-address + k 
to the values specified by valueg 
through valuej^. If the delimiter 
separating the address from the 
first value is a plus or minus 
sign, the EC or SC command is 
redisplayed with a new start- 
address + k+1. The redisplayed 
command may be completed with new 
values to continue setting 
locations. This process con- 
tinues until the delimiter is 
changed to something other than 
plus or minus or until the escape 
key is used to cancel the command. 
Using the minus sign as a de- 
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???[^sm5 
???{^sn3 



limlter causes the data to be 
stored at descending addresses. 
A total of 39 characters can be 
input for values and their 
delimiters. Any additional 
characters are ignored. 



[/] start-address/ value 







[..../valuej^] A 

Set mainstore locations as 



in 



the EC/SC commands. 



[/] start-address/value^ [... ./valuej^lA 



???R [/] start-address /end-address ■■ [, 



???T[/]t^ [ /tj^)A 



???DS[/] address J.... /address ]A 



???LD[/] track/file/unit [/G]A 



Set nanostore locations as in 
the EC/SC commands. 

, /start-addressjj/end-addressj^] A 

Define the ranges or nanostore 
addresses in which the stretch 
bit will be set in selected T- 
vectors when the words are 
loaded. The addresses are nano 
word addresses, not word-byte 
addresses. 

Define the T-vectors in which 
the stretch bit is to be set in 
words loaded within the ranges 
specified by the R command. 
Only values of 1, 2, 3, or 4 are 
allowed for tn. 

Define stretch patch. When any 
of the specified addresses are 
loaded from the cart tape, the 
stretch bit in the corresponding 
T- vector will be set. Only 
addresses xxxx07, xxxx13, xxx17, 
and xxxx23 are valid. Other 
addresses are not processed, and 
no error Indication is given. 
This command sets stretch bits 
independently of the R and T 
commands . 

Load the cart tape file specified. 
Stretch bits will be set in all 
T-vectors specified by the R and 
T commands or by the DS command. 
If G is entered, pass control to 
the loaded program when a start 
record is encountered. 
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???LU[/]track/f lie/unit [/G]A 



???GOA 



???MS[/]addressA 



???NS [ /] address/FIDX-setting A 



Load the cart tape file specified. 
No stretch bits are set. If G 
is entered, pass control to the 
loaded prograim when a start 
record is encountered. 

Perform a microstart as specified 
by the last microstart record read 
from the cart tape file. 

Perform microstart at address 
specified. 

Perform nanostart at address 
specified, with FIDX set as 
specified. Address is a nano 
word address, not a word-byte 
address. 



Table A-3: LSP Command Description 
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How to Prepare a Cartridge Tape Containing LSP 

LSP is a relocatable program that can be loaded at any loadpoint specified 
in the PREP utility. The microstart array starts at the loadpoint. 

The following procedure uses a loadpoint of 20000o as an example of 
offsetting the loadpoint to an address other than zero. 

1) Invoke PREP. 

2) Using the H command, put the header record on the tape. 

3) Using the M command, offset the LSP binary code to the required 
loadpoint. 

#M MICRO BINARY FILE = LSP:B[+20000]A 

Steps 4 and 5 are performed only if the loadpoint is offset. 

4) Using the C command, store the value of the loadpoint + lOOg in the 
location of the loadpoint + 33g- 

#C PRESET CODE (NANOSTORE. CONTROLSTORE . MAINSTORE = C 
FROM 20O33A TO 20033 A VALUE 20100A 

5) Using the C command, store the value of the loadpoint in the location 
of the loadpoint + 35q. This serves as the base address of the 
program. 

#C PRESET CODE (NANOSTORE CONTROLSTORE. MAINSTORE) = C 
FROM 20035A TO 20035A VALUE 20000A 

6) If a system console baud rate other than 9600 baud is desired, then 
using the C command, place the new baud rate (exactly as it occurs in 
the DCWA of the asynchronous communication controller) at the location 
of the loadpoint +17g. 

7) Using the S command, create a microstart record with a start address 
indicating the loadpoint. 

£ START CODE (HARDSTOP. NANOSTART. MICROSTART) = M 

START ADDRESS = 20000A 
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Any other programs may precede or succeed LSP on the cart file. However, 
no control store routines should overlap the address space of LSP. The 
microstart record should point to LSP's microstart array located at the 
loadpoint. Control can be transferred to the other routines via the MS 
(microstart command) of LSP. 
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STAND ALONE DDMP PROGRAM 

The stand alone dump program dumps the contents of a specified range of 
control store or mainstore to the line printer. Memory addresses and 
contents of memory locations are output in octal format, six octal digits 
per word, 8 locations per line. 

This dump program is stored on cartridge tape and is booted directly into 
memory. It usually occupies control store 5200g-5777g« 



1 ) Insert the cartridge tape containing the stand alone dump program into 
the tape unit. 

2) Set the F switches to select the track and file containing the dump 
program. 

3) Press MASTER CLEAR and START to load the dump program. When loaded, 
the cursor moves to the beginning of the next line on the CRT and 
displays #. 

M) Type in the boundary addresses (in octal) of the memory being dumped, 
followed by M or C to select either mainstore or control store. A 
carriage return instead of M or C causes a default to control store, or 
the last entered. 



'&) 



Format: # nnnnnng A nnnnnnp 

A is any QM-1 delimiter (hyphen, comma, blank, period). 

Leading zeros may be omitted. 
After M, C, or A is entered, the contents of the specified memory range is 
output to the printer. A new set of boundary addresses may then be 
entered. As many dumps as desired may be taken from either mainstore or 
control store by typing in a new set of boundary addresses after each 
output to the printer. Printing may be interrupted at any time by entering 
an Escape character (ESC). 
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STATESAVE PBOCEDDRE 

STATESAVE saves the state of registers in control store locations 200-312. 
Once saved, the stand-alone dump or LSP can be used to display the state. 

1) Set the F-switches to 77. 

2) Set the MODE switch to IML. 

3) Press MC. 

4) Press START. 

The state is now saved. The following table shows the control store 
locations used to store each register. Reserving locations 200-312 of 
control store as non-program space, allows STATESAVE to be executed 
without loss of information. E-store 7 is destroyed and displays the 
contents of local store 37. 



Controlstore 

location Register 

200-237 

240-277 

300 

301 

302 

303 

304 

305 

306 

307 

310 

311 
312 

Table A-4. Statesave Storage Locations 



local 


store 




0-37 


external store 


0-37 


FMIX 


FMOD 


FCIA 




FAIL 


FCID 


FAIR 




FOOD 


FAOD 


FSID 




FSOD 


FEID 


FEOD 




FEIA 


FEOA 


FACT 




FUSH 


FMPC 


FIDX 




FIST 


FIPH 


00 




G1 


02 


03 




G4 


05 


06 




G7 


010 


Oil 




012 


013 
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